Api.Create 方法

準備將程式連結到 KINGSTAR 子系統。

命名空間：IntervalZero.KINGSTAR.Local.Api

組合： IntervalZero.KINGSTAR.Local.Api (於 IntervalZero.KINGSTAR.Local.dll) 版本：4.4.0.0

語法

public KsError Create(
       int Instance,
       int IdealProcessor
)

Public Function Create(
       Instance As Integer,
       IdealProcessor As Integer
) As KsError

參數

Instance

型別：int

在有多主站套件的情況下選擇想要使用的 KINGSTAR Runtime 實例。若沒有此套件，請將其設定為零 (0)；若有此套件，則有效的實例應為 0 <= instance <= 63。此實例可依照您的需要而設，例如：您有三個實例並想使用第三個，則將之設為二（2）。

IdealProcessor

型別：int

設定 KINGSTAR 子系統運作的核心。子系統的所有執行緒將在給定的處理器上運作。核心零固定分配給 Windows。您可根據您的設定將其他核心分配給子系統。預設情況下，IdealProcessor 設定為零，表示 KINGSTAR 將使用實例配置表中所配置的處理器（KINGSTAR 控制台 > Runtime 設定 > 一般設定）。若該表中缺少給定實例的設定，則子系統可在 RTX64 可用的任何核心上運作。若您將 IdealProcessor 設定為其他數字，例如二，則子系統將使用核心二。

回傳值

型別：KsError

方法的回傳代碼。

備註

• 此方法應第一個被呼叫。若未先呼叫 Create 方法，則所有其他方法都會回傳錯誤。
• 若未啟動 多主站套件，使用此方法且 Instance 設定大於零時，將回傳 errNoLicense。在沒有 多主站套件 的情況下，僅能將 Instance 設定為零。
• 多實例代表您有多個 ksRuntime.rtss 同時執行中且控制著不同的網卡，若您備有 多主站套件，可使用多個 Create 來建構多個實例。例如，有三個 Create 函式，則這些函式可各自使用實例零、一和二；若沒有 多主站套件，您可使用多個 Create 來建構唯一一個實例，即實例零。多個應用程式可連結到同一個 KINGSTAR Runtime，但單一應用程式不可連結到多個 KINGSTAR Runtime。
• 一個 KINGSTAR Runtime = 一個 ksRuntime.rtss。
• Create 方法不能從執行緒集區或背景執行緒中呼叫，因為某些 RTX64 元件無法從這些位置初始化。

範例

N/A

參見

Api 類別

IntervalZero.KINGSTAR.Local.Api 命名空間